<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <meta name="generator" content="HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />

  <title>pydelicious</title>
<style type="text/css">
/*<![CDATA[*/

/*
:Author: David Goodger
:Contact: goodger@users.sourceforge.net
:Date: $Date: 2005-12-18 01:56:14 +0100 (Sun, 18 Dec 2005) $
:Revision: $Revision: 4224 $
:Copyright: This stylesheet has been placed in the public domain.

Default cascading style sheet for the HTML output of Docutils.

See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/

/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
  border: 0 }

table.borderless td, table.borderless th {
  /* Override padding for "table.docutils td" with "! important".
     The right padding separates the table cells. */
  padding: 0 0.5em 0 0 ! important }

.first {
  /* Override more specific margin styles with "! important". */
  margin-top: 0 ! important }

.last, .with-subtitle {
  margin-bottom: 0 ! important }

.hidden {
  display: none }

a.toc-backref {
  text-decoration: none ;
  color: black }

blockquote.epigraph {
  margin: 2em 5em ; }

dl.docutils dd {
  margin-bottom: 0.5em }

/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
  font-weight: bold }
*/

div.abstract {
  margin: 2em 5em }

div.abstract p.topic-title {
  font-weight: bold ;
  text-align: center }

div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
  margin: 2em ;
  border: medium outset ;
  padding: 1em }

div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
  font-weight: bold ;
  font-family: sans-serif }

div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title {
  color: red ;
  font-weight: bold ;
  font-family: sans-serif }

/* Uncomment (and remove this text!) to get reduced vertical space in
   compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
  margin-bottom: 0.5em }

div.compound .compound-last, div.compound .compound-middle {
  margin-top: 0.5em }
*/

div.dedication {
  margin: 2em 5em ;
  text-align: center ;
  font-style: italic }

div.dedication p.topic-title {
  font-weight: bold ;
  font-style: normal }

div.figure {
  margin-left: 2em ;
  margin-right: 2em }

div.footer, div.header {
  clear: both;
  font-size: smaller }

div.line-block {
  display: block ;
  margin-top: 1em ;
  margin-bottom: 1em }

div.line-block div.line-block {
  margin-top: 0 ;
  margin-bottom: 0 ;
  margin-left: 1.5em }

div.sidebar {
  margin-left: 1em ;
  border: medium outset ;
  padding: 1em ;
  background-color: #ffffee ;
  width: 40% ;
  float: right ;
  clear: right }

div.sidebar p.rubric {
  font-family: sans-serif ;
  font-size: medium }

div.system-messages {
  margin: 5em }

div.system-messages h1 {
  color: red }

div.system-message {
  border: medium outset ;
  padding: 1em }

div.system-message p.system-message-title {
  color: red ;
  font-weight: bold }

div.topic {
  margin: 2em }

h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
  margin-top: 0.4em }

h1.title {
  text-align: center }

h2.subtitle {
  text-align: center }

hr.docutils {
  width: 75% }

img.align-left {
  clear: left }

img.align-right {
  clear: right }

ol.simple, ul.simple {
  margin-bottom: 1em }

ol.arabic {
  list-style: decimal }

ol.loweralpha {
  list-style: lower-alpha }

ol.upperalpha {
  list-style: upper-alpha }

ol.lowerroman {
  list-style: lower-roman }

ol.upperroman {
  list-style: upper-roman }

p.attribution {
  text-align: right ;
  margin-left: 50% }

p.caption {
  font-style: italic }

p.credits {
  font-style: italic ;
  font-size: smaller }

p.label {
  white-space: nowrap }

p.rubric {
  font-weight: bold ;
  font-size: larger ;
  color: maroon ;
  text-align: center }

p.sidebar-title {
  font-family: sans-serif ;
  font-weight: bold ;
  font-size: larger }

p.sidebar-subtitle {
  font-family: sans-serif ;
  font-weight: bold }

p.topic-title {
  font-weight: bold }

pre.address {
  margin-bottom: 0 ;
  margin-top: 0 ;
  font-family: serif ;
  font-size: 100% }

pre.literal-block, pre.doctest-block {
  margin-left: 2em ;
  margin-right: 2em ;
  background-color: #eeeeee }

span.classifier {
  font-family: sans-serif ;
  font-style: oblique }

span.classifier-delimiter {
  font-family: sans-serif ;
  font-weight: bold }

span.interpreted {
  font-family: sans-serif }

span.option {
  white-space: nowrap }

span.pre {
  white-space: pre }

span.problematic {
  color: red }

span.section-subtitle {
  /* font-size relative to parent (h1..h6 element) */
  font-size: 80% }

table.citation {
  border-left: solid 1px gray;
  margin-left: 1px }

table.docinfo {
  margin: 2em 4em }

table.docutils {
  margin-top: 0.5em ;
  margin-bottom: 0.5em }

table.footnote {
  border-left: solid 1px black;
  margin-left: 1px }

table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
  padding-left: 0.5em ;
  padding-right: 0.5em ;
  vertical-align: top }

table.docutils th.field-name, table.docinfo th.docinfo-name {
  font-weight: bold ;
  text-align: left ;
  white-space: nowrap ;
  padding-left: 0 }

h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
  font-size: 100% }

tt.docutils {
  background-color: #eeeeee }

ul.auto-toc {
  list-style-type: none }

/*]]>*/
</style>
</head>

<body>
  <div class="document" id="pydelicious">
    <h1 class="title">pydelicious</h1>

    <p>Basicly, a Python library to access del.icio.us. Includes shell utility to manage a local collection of bookmarks.</p>

    <p>Based on work done by Frank Timmermann<a class="footnote-reference" href="#id10" id="id1" name="id1"><sup>1</sup></a>. See <a class="reference" href="./license.txt">license.txt</a>.</p>

    <div class="section">
      <h1><a id="overview" name="overview">Overview</a></h1>

      <p>Access to the del.icio.us web service API is implemented in <a class="reference" href="./pydelicious.py">pydelicious.py</a>.</p>

      <dl class="docutils">
        <dt><a class="reference" href="./tools/dlcs.py">tools/dlcs.py</a></dt>

        <dd>an executable script that offers command-line access to your bookmark collection.</dd>

        <dt><a class="reference" href="./doc">doc/</a></dt>

        <dd>Documentation generated from source.</dd>

        <dt><a class="reference" href="./tests">tests/</a></dt>

        <dd>Unittest-cases.</dd>

        <dt><a class="reference" href="./var">var/</a></dt>

        <dd>Test data, etc.</dd>
      </dl>
    </div>

    <div class="section">
      <h1><a id="documentation" name="documentation">Documentation</a></h1>

      <p>For help and TODO's, progress reporting:</p>

      <ul>
        <li>
          <p class="first"><a class="reference" href="./doc/pydelicious.html">pydelicious.py</a></p>
        </li>

        <li>
          <p class="first"><a class="reference" href="./doc/dlcs.html">dlcs.py</a></p>
        </li>
      </ul>

      <p>Other TODO's:</p>

      <ul>
        <li>
          <p class="first">Integrate tests/pydelicioustest.py, tests/pydelicious-test-utf-8.py</p>
        </li>

        <li>
          <p class="first">blackbox tests have encoding issues...</p>
        </li>
      </ul>
    </div>

    <div class="section">
      <h1><a id="configuration" name="configuration">Configuration</a></h1>

      <div class="section">
        <h2><a id="resolution" name="resolution">Resolution</a></h2>

        <p>In order of preference:</p>

        <blockquote>
          <ul>
            <li>
              <p class="first">'.dlcs-rc' in the current working directory</p>
            </li>

            <li>
              <p class="first">'DLCS_CONFIG' environment variable</p>
            </li>

            <li>
              <p class="first">if those two don't exist: '~/.dlcs-rc'</p>
            </li>

            <li>
              <p class="first">finally, value passed with '-c' or '--config' overrides all</p>
            </li>
          </ul>
        </blockquote>
      </div>
    </div>

    <div class="section">
      <h1><a id="references" name="references">References</a></h1>

      <table class="docutils footnote" frame="void" id="id10" rules="none">
        <colgroup>
          <col class="label" />
          <col />
        </colgroup>

        <tbody valign="top">
          <tr>
            <td class="label"><a name="id10" id="id10">[1]</a></td>

            <td>Google Code, <tt class="docutils literal"><span class="pre">pydelicious</span></tt> (<a class="reference" href="http://code.google.com/p/pydelicious/">http://code.google.com/p/pydelicious/</a>).</td>
          </tr>
        </tbody>
      </table>
    </div>
  </div>

  <div class="footer">
    <hr class="footer" />
    Generated on: 2007-07-09.
  </div>
</body>
</html>
